Copyright: Funduc Software, Inc.


Search and Replace windows
      Search and Replace for Windows Help Contents - Version 2.83

                         Copyright 1995-1997 Funduc Software Inc.

Search and Replace is a Search (grep) utility you can use to find a given string in multiple files.  In the registered version, you can replace some, all or none of these strings with another string.  In the shareware version, you can only replace in the first file in each session.  A touch button allows you to change the date and time of the files you specify.  The Search Results list allows you to view the file using the associated viewer or the context of the line where the string was found (see Search and Replace for Windows main dialog).  Regular expressions are supported for both Search and Replace (registered version only).  See Regular Expression Support for more details.  You can create Scripts for multiple Search/Replace strings and/or multiple paths and masks to process.  For processing multiple lines or Using Special Characters see the Binary Mode dialog ( [image] buttons next to the Search and Replace fields).

Basic Information:

A Quick How-To Guide

Graphic Overview of the Search and Replace Main Screen

Purchase & Order Search and Replace for Windows

License Information

Customer Support

Acknowledgments

Product Information

Detailed Topics:

Search and Replace Main Window

Search and Replace Options

Scripts

Regular Expressions

Binary Mode Editor

Special Characters

Touch dialog

Action Menu

Edit Menu

View Menu

Command Line Parameters.

About dialog


Quick How-To Guide

Start a search:  Enter (or select from combo boxes) a search string, one or more file masks and a path.  Then click Search.  For more information see Search and Replace for Windows main dialog.  ZIP files are searched by default.  To configure that and many other items see Options dialog.

Use Special Characters or Multiple Lines in Search or Replace:  Click the [image] button to the right of the Search or Replace String field to use multiple lines or special characters for that field.  The Binary Mode dialog will be displayed.  When you are done creating the string "Binary mode -->>" is displayed on the main dialog.  To view the string later, click the button again (it cannot be shown on the main screen).  You can also add several lines to the beginning or the end of the files processed.

Set Up Include &/or Exclude File Masks:  File masks follow the syntax of the DOS dir command (e.g., *.*;*.txt;*.doc;*.??1).  You can specify more than one mask can be specified via a semicolon separator.  Exclude masks use the ~ character to denote a mask NOT to search (e.g., *.*;~*.swp;~*.exe;~*.dll).  To specify a ~ as part of the file mask, use \~ (e.g, *.*;\~*.tmp).  For more information, File Masks.

Start a replace (registered version only):  Enter (or select from combo boxes) a search string, a replace string, one or more file masks and a path.  Then click Search & Replace.  For more information see Search and Replace for Windows Main dialog.

Change Options:  Click the Options button (see Options dialog).  Among the options you can change are the colors to use for display, how often to prompt during replaces, a file(or printer) to write the output to, number of items to save in the combo boxes, etc.

View the Context of a Search Result:  Double-click the Search Result or click the right (left for left-handers) mouse button and use the pop-up menu.  The internal context viewer can display text files.  However, Search and Replace can automatically view binary files using our external utility, HexView for Windows 95/NT.  The registered version allows you to edit the file using the internal context viewer.

Open a File Listed in Search Results :  To open the file using the associated program, double-click the "Processing file..." line in the Search Results or click the right (left for left-handers) mouse button and use the pop-up menu.

Use Regular Expressions:  See Regular Expression Support.  Regular expressions are supported for Search and Replace (replacing allowed only in registered version).

Use Scripts for Multiple Search and Replace strings or Paths:  You can save scripts containing multiple Search/Replace strings and/or paths and file masks to process.  See the see Script dialog for more information.

Use Command Line Parameters:  See Command Line Parameters.  For all practical purposes, only the Windows 95/NT version can be used from the command line.

Find Files only:  Enter one or more file masks and a path.  Do not enter a Search String (or blank it out).  Then click Search.  For more information see Search and Replace for Windows main dialog.

Touch Files:  Enter (or select from combo boxes) one or more file masks and a path.  You will be prompted for a date and time to use for all the files.


Actions Menu

Search:  Select this item to start a search.

Search and Replace:  We recommend that if you use this feature you also enter a backup path in the Options dialog. Select this item to start a search and replace.

Touch:  Select this item to touch the files found using the mask(s) provided in the specified directory.

Exit:  Select this item to exit the application.


Edit Menu

Copy Search Results:  Select this item to copy the Search Results (if any) to the clipboard.  If the Search Results list contains nothing, this item is not available.


View Menu

Open with Associated File:  Select this item to open the current file in the Search Results (if any) using the associated viewer.  If no viewer is associated with that file extension, the default viewer, configurable in the General Options tab under Options, is used (default is NOTEPAD.EXE).  The file to open is determined by the focus in the Search Results list (marked by a thin rectangle or a highlight).  If the Search Results list contains nothing, this item is not available.  If the file is in a ZIP file, it is extracted to a subdirectory of the path specified in the Search Options tab.  If you edit it, you must then update the ZIP file since ZIP files are NOT automatically updated.

Open with Default Viewer:  Select this item to open the current file in the Search Results (if any) using the Search and Replace default viewer (configurable in the configurable in the General Options tab under Options).  NOTEPAD.EXE is used if no default viewer has been defined.  The file to open is determined by the focus in the Search Results list (marked by a thin rectangle or a highlight).  If the Search Results list contains nothing, this item is not available.  If the file is in a ZIP file, it is extracted to a subdirectory of the path specified in the Search Options tab.  If you edit it, you must then update the ZIP file since ZIP files are NOT automatically updated.

Open with...:  Select this item to open the current file in the Search Results (if any) using a viewer of your choice.  A Select Viewer dialog will allow you to select the viewer to use.  The file to open is determined by the focus in the Search Results list (marked by a thin rectangle or a highlight).  If the Search Results list contains nothing, this item is not available.  If the file is in a ZIP file, it is extracted to a subdirectory of the path specified in the Search Options tab.  If you edit it, you must then update the ZIP file since ZIP files are NOT automatically updated.

View Context:  Select this item to view the current line in the Search Results (if any) and several lines before and after it using the Search and Replace internal context viewer.  The file to open is determined by the focus in the Search Results list (marked by a thin rectangle or a highlight).  If the Search Results list contains nothing or if you have the focus on a file line, this item is not available.  Note that the Search and Replace context viewer displays text only.  However, Search and Replace automatically detects binary files and will launch our freeware application, HexView for Windows 95/NT, in order to view the context in binary files.  See Product Information for further details on HexView.  Finally, note that if the results context is a file inside a ZIP file, it is extracted to a subdirectory of the path specified in the Search Options tab.  If you edit it, you must then update the ZIP file since ZIP files are NOT automatically updated.  See the View Context dialog for more information about viewing the context of search finds.

Script:  Select this item to display the Script Editor.

Options:  Select this item to display the Options dialog.


Search and Replace main window
Search and Replace for Windows Main Dialog

Note: See Graphic Overview of the Search and Replace Main Screen for more information.

The Search and Replace for Windows Utility allows you to search (and replace it with another string if you wish) for a given string in a set of files you specify on a path you specify.  You can also use the application as a file finder by not entering a Search String.  The dialog box is sizable, maximizable and minimizable for your convenience.  The found strings and the files they are found in are clearly displayed in a list box using a customizable color.

Search String field:  Enter the string to search for in this field or select a previous search string from the combo list.  Your last few search strings are saved for you by the application and you can find them in the combo box list.  If you do not enter a Search String, the File Mask and Path fields will be used to execute a File Find, with the results displayed in the Search Results list.

Search String Browse button ( [image]):  Click to use multiple lines or special characters for the Search field.  The Binary Mode dialog will be displayed to allow you to create the multiple line and/or special character Search String.  When you are done creating the string "Binary mode -->>" is displayed on the main dialog.  To view the string later, click the button again (it cannot be shown on the main screen).

Replace String field:  Enter the string to replace with in this field or select a previous replace string from the combo list.  Your last few strings to replace are saved for you by the application and you can find them in the combo box list.

Replace String Browse button ( [image]):  Click to use multiple lines or special characters for the Replace field.  The Binary Mode dialog will be displayed to allow you to create the multiple line and/or special character Replace String.  When you are done creating the string "Binary mode -->>" is displayed on the main dialog.  To view the string later, click the button again (it cannot be shown on the main screen).

File Mask field:  One or more include &/or exclude search masks for search files.  The masks are those used in the DOS dir command (e.g., *.*;*.txt;*.doc;*.??1).  More than one mask can be specified by using a semicolon separator (see example above). Exclude masks use the ~ character to denote a mask NOT to search (e.g., *.*;~*.swp;~*.exe;~*.dll).  To specify a ~ as part of the file mask, use \~ (e.g, *.*;\~*.tmp).  Your last few search file masks are saved for you by the application and you can find them in the combo box list.  See File Masks for more information.

Path field:  Path where files to search reside.  You may type it by hand, navigate to it by using the Browse button below, or select a previously used path from the combo list.  Your last few search paths are saved for you by the application and you can find them in the combo box list.

Path Browse button ( [image]):  Click to select  the path where files to search reside.  The Select Path dialog will be displayed to allow you to visually select the path.  If the Path field (described above) contains a valid path, it will be your starting path in the Select Path dialog.  Otherwise, the current path will be used.

Case sensitive field:  Check this field if you want the search to be case sensitive.  Uncheck it if you want to search regardless of case.

Search subdirectories field:  Check this field if you want to search all subdirectories of your path (this will usually slow your search down).  Uncheck it if you just want to search the specified path.

Match Whole Word:  Check this field if you want to look for the exact word or phrase specified (enclosed by whitespace).  For example, if this option is on and you look for "Window", the program will find it in the phrase "...use the Window menu..." but not in the phrase "...Windows 95...".  If this option is not checked, both occurrences will be found.

Regular Expression field:  Check this field if you want to use a regular expression.  Case sensitive and binary mode can be used in conjunction with this type of search. When regular expression is enabled, the Match Whole Word function is not available.  See Regular Expression Support for more information on the syntax supported.

Search Results List:  Your search results are displayed there.  The file name and the strings found are displayed in different colors (if you cannot see them, try changing the colors from the Options dialog).  By double clicking on a line where a search string is displayed, you can either display the View Context screen or Shell the executable associated with it (in File Manager).  You can also use the right mouse button to display a menu or use the Ctrl+C key to copy the list box contents to the Clipboard.

Search button:  Click this button to start a search.

Search and Replace button:  We recommend that if you use this feature you also enter a backup path in the Options dialog.  Click this button to start a search and replace.

Options button:  Click this button to display the Options dialog.

Script button:  Click this button to activate the Script Editor.

Touch button:  Click this button to touch the files found using the mask(s) provided in the specified directory.

About button:  Click this button to view system information, Ordering Information and licensing information.

Exit button:  Click this button to exit the application.


Options Dialog description
Options Dialog

The Options are split in the following major categories.  Click on the Tabs at the top to switch between them.  The categories are:

General Options:  Number of items to save in the drop down lists, View context fonts & # of lines, Display colors, Default file association.

Search Options:  Maximum regular expression size, zip search enable/disable, unzip temporary directory.

Replace Options:  Backup file path definition & write enable/disable, Replace prompts.

Output Options:  Hit line display options, Write output file definition, Characters to demark search finds.

OK button:  The changes will be made.

Cancel button:  The changes will not be made.


Options: General
General Options

Note: Also see Search Options, Replace Options, & Output Options for information on other settings.

Number of items to save:  Select the maximum number of items to save in the Search String, Replace String, Mask and Path drop down combo boxes.

Number of lines to view:  Select the number of items before and after the hit line to view in the View Context dialog.

Found Color Button:  Choose this button to display the Color dialog to select a new color for the found strings in the list.

File Color Button:  Choose this button to display the Color dialog to select a new color for the file names where the strings were found.

If no association use and Browse button:  Enter a file name for the default viewer (to be used when a file has no association). You may also use the Browse button to select a default viewer, in which case you will see Select Viewer dialog.

View Context Font Button:  Choose this button to display the Font dialog to select a new font for the View Context dialog.


Options: Search
Search Options

Note: Also see General Options, Replace Options, & Output Options for information on other settings.

Search ZIP files:  If you check this box, any ZIP files (created with PKZIP or compatible utilities) in the search path(s) will be examined and any files with the masks specified will be extracted and searched.  This option is only available for Searches (not Replaces).  This option may slow down your searches, so you should turn it off if you do not need it.

Max Reg. Expr .field:  Enter the maximum number of bytes to allow for searching for a regular expression (such as *).  See Regular Expression Support for more details.  The maximum allowed is 4096 (4K).

Unzip files to:  A path where the contents of ZIP files will be extracted for Searching (see above).  The default is the temporary directory defined by your computer's operating system, typically "Windows\Temp".  Subdirectories will be created and removed as needed under the specified path.


Options: Replacements
Replace Options

Note: Also see General Options, Search Options, & Output Options for information on other settings.

Backup Path and Browse button ( [image]):  Select a backup path if you want your old files backed up.  You may also use the Browse button to select a path, in which case you will see the Select Path dialog.  The directory tree will be created if needed during the Replace operation (if Search Subdirectories was checked)

Write Files to Backup Path field:  Check this box if you want to write the changed files to the backup directory.  Also specify a Backup Directory.  The directory tree will be created if needed during the Replace operation (if Search Subdirectories was checked).

Search and Replace group:  Select "Prompt On All" to get a prompt on every string to be replaced in every file.  Select "Prompts on Each File" to get a prompt for all occurrences in each file. (If you use this option, you may not realize exactly the context of every string you replace).  Select "No Prompts" to not get any prompts at all for all replaces. (If you use this option, you may not realize exactly the context of every string you replace or which files you replace them in until after the operation is finished).


Output Options

Note: Also see General Options, Search Options, & Replace Options for information on other settings.

Hit Line Display:  When checked -

  Display Files Without Hits will cause the display to list the filenames where no occurrences of the search string were found.  Note that if this is the only box checked, the display will not list files were the search string is present.

  Display First Hit Line will cause the display to list the filenames and the highlighted context of where the search string was found.  If you are searching across multiple lines, the first line will be displayed.  Note that if this is the only box checked, you'll only get feedback from files where the search string was found.

  Display Replace String will cause the display to list the filenames, replacements, and total counts for all replacements.  Note that if this is the only box checked, you won't see the context of each replacement.  Check "Display First Hit Line" if you want to see the full replace contexts.

  Display Number of Hits in File list the filename(s) and number of times the search string was found in that file.  Note that if "Display First Hit Line" is not checked, the only thing listed will be the number of hits.  Select this if you only want to know how many hits were found in each file.

Show Output to File and Browse button:  Enter a file name (if no path is specified, the current directory is used) for a file where the list output will be directed.  If this field is blank, no file is produced.  You may also use the Browse button ( [image]) to active a File Save As dialog that you may use to select a subdirectory &/or specific file.  The default suggestion for this File Save As dialog is the file "Results.txt."  However, you are free to use any filename.  Note that what is written to this file is the same information presented in the Search & Replace results display.  Therefore, to adjust the output, make selections in the "Hit Line Display" checkboxes.

Before Hit:  You can change the string displayed before hits in clipboard dump or in the Output File.  If you do not want anything displayed, blank out this field.

After Hit:  You can change the string displayed after hits in clipboard dump or in the Output File.  If you do not want anything displayed, blank out this field.


scripts: using
Script Dialog

The Script dialog allows you to create and edit Search and Replace scripts.  You can use a script to specify multiple search/replace combinations for processing, to save a particular Search or Replace string for later use, or to process multiple drives/directories and/or file masks.  You can override the Search and Replace strings in the main dialog and still use the Masks and Paths, or you can override anything but the list of paths, or only use the Search/Replace list on a path and mask specified in the main window.  The scripts are stored in ASCII text format so that they can be edited or printed.  To convert scripts created with earlier versions of the program, load them, then save them using the same name.

The script editor consists of three main components: Multiple Search & Replace Strings, Multiple Paths & Filemasks, and Script File Operations.  A graphic view of the Script Editor is also available.  Select the topics below for additional details.

Graphic Overview of the Script Editor

Multiple Search and Replace Items in Scripts

Multiple Paths and File Masks Items in Scripts

Script File Operations

Format of Script Files

Please note:

  You can enter Search strings only, both Search and Replace strings, Path and mask strings only, or all the fields in a script.  You can also override some of the values from the main window by entering new Search and Replace strings or new Path and Mask strings.  As new versions come out, more functionality will be added in this area.

  When a script is active, the Search, Replace, File Mask, and Path fields in the Search and Replace main window will change to reflect the script in use.  For example, given a script named, example.srs, which only has settings for a search string, the Search field in the main window will change to read "Use Script file: d:\example.srs".  If example.srs also involved a replace string and a file mask, the Replace and File Mask fields would also change to read, "Use Script file: d:\example.srs".


Script Editor: Multiple Search and Replace Items

Also see the Graphic Overview of the Script Editor, Multiple Paths and File Masks in Scripts, Script File Operations, and Format of Script Files for further information on scripts.

Search String field:  Enter the string to search for in this field.  Selecting a row in the Search/Replace List will display the information for that row and allow you to edit it.  When you are done with this field, the Replace string and the Case Sensitive, Regular Expression and Match Whole Word settings, you can click Apply to save the information.

Search String Binary Mode button ( [image]):  Click this to activate the Binary Mode dialog.  You can use the Binary Mode dialog to create searches that span multiple lines or to insert special characters for the Search field.  When you are done creating the string, "Binary mode -->>", is displayed in the search string area. If you want to double check your entry or make changes, click the button again.

Replace String field:  Enter the string to search for in this field.  Selecting a row in the Search/Replace List will display the information for that row and allow you to edit it.  When you are done with this field, the Search string and the Case Sensitive, Regular Expression and Match Whole Word settings, you can click Apply to save the information.

Replace String Binary Mode button ( [image]):  The operation here parallels the Search String binary mode editor.  Click to use multiple lines or special characters in the Replace field.  The Binary Mode dialog will be displayed to allow you to create the multiple line and/or special character Replace String.  When you are done creating the string "Binary mode -->>" is displayed.  To view the string later, click the button again.

Case Sensitive field:  Check this if you want the search to be case sensitive.  Uncheck it if you want to search regardless of case. To save the information for the current row when you are done, click Apply (in the same group).

Match Whole Word:  Check this field if you want to look for the exact word or phrase specified (enclosed by whitespace).  For example, if this option is on and you look for Window, the program will find it in the phrase ...use the Window menu... but not in the phrase ...Windows 95....  If this option is not checked, both occurrences will be found. To save the information for the current row when you are done, click Apply (in the same group).  Note that this field will be not be available if Regular Expressions are turned on.

Regular Expression field:  Check this field if you want to use a regular expression.  Case sensitive and binary mode can be used in conjunction with this type of search. See Regular Expressions for more information on the syntax supported. To save the information for the current row when you are done, click Apply (in the same group).

Apply button for Search/Replace List:  Click this button to save the information for the currently selected row.

Remove button for Search/Replace List:  Click this button to delete the information for the currently selected row.

Remove All button for Search/Replace List:  Click this button to remove all the Search/Replace rows (to start a new script for example).

Move Up button for Search/Replace List:  Click this button to move the information for the currently selected row up by one row.

Move Down button for Search/Replace List:  Click this button to move the information for the currently selected row down by one row.

Insert button for Search/Replace List:  Click this button to insert a new Search/Replace row above the currently selected row.


Script Editor: Multiple Paths and File Masks

Also see the Graphic Overview of the Script Editor, Multiple Search and Replace Items in Scripts, Script File Operations, and Format of Script Files for further information on scripts.

File Mask field:  One or more include &/or exclude search masks for search files.  The masks are those used in the DOS dir command (e.g., *.*;*.txt;*.doc;*.??1).  More than one mask can be specified by using a semicolon separator (see example above).  Exclude masks use the ~ character to denote a mask NOT to search (e.g., *.*;~*.swp;~*.exe;~*.dll).  To specify a ~ as part of the file mask, use \~ (ie *.*;\~*.tmp).  To save the information for the current row when you are done, click Apply (in the same group).  (See File Masks for more information on using defining masks.)

Path field:  Path where files to search reside.  You may type it by hand, navigate to it by using the Browse button below.  To save the information for the current row when you are done, click Apply (in the same group).

Path Browse button ( [image]):  Click to select the path where files to search reside.  The Select Path dialog will be displayed to allow you to visually select the path.  If the Path field (described above) contains a valid path, it will be your starting path in the Select Path dialog.  Otherwise, the current path will be used.   To save the information for the current row when you are done, click Apply (in the same group).

Path/Mask List:  The items currently saved in this script are displayed.  To change a specific row, select it in this list.  The information for the row will then be displayed and you can then modify or delete it as you wish.

Apply button for Path/Mask List:  Click this button to save the information for the currently selected row.

Remove button for Path/Mask List:  Click this button to delete the information for the currently selected row.

Remove All button for Path/Mask List:  Click this button to remove all the Path/Mask rows (to start a new script for example).

Move Up button for Path/Mask List:  Click this button to move the information for the currently selected row up by one row.

Move Down button for Path/Mask List:  Click this button to move the information for the currently selected row down by one row.

Insert button for Path/Mask List:  Click this button to insert a new Path/Mask row above the currently selected row.


Script Editor: Script File Operations

Save As button:  Click this button to save the created/modified script to disk.

Load button:  Click this button to load a script from disk for editing or using Search, Search and Replace, Touch or File Find.

Use Script button:  Click this button to use the script for Search, Search and Replace, Touch or File Find.  You can override several of the script settings in the main window (see Scripts for details).

Cancel button:  Exits the dialog without using the script settings.  If you made changes to a script, you are asked whether you want to save the information.


Script Editor: Format of Script Files

Also see the Graphic Overview of the Script Editor, Multiple Search and Replace Items in Scripts, and Multiple Paths and File Masks Items in Scripts for further information.

Format of the Script file:  Scripts are saved as ASCII files.  The safest way to create a valid script is to use the Script dialog, then to edit the resulting file and perhaps to cut and paste to add new steps.  A simple script file looks like this:

[Script for Search and Replace]

[Search]

String to Search for number 1

[Replace /b]

String to Replace with number 1

[Search /bix]

String to Search for number 2

[Replace]

String to Replace with number 2

[Path]

c:\*.ini

[Path]

d:\work\*.txt

[End of Search and Replace Script]

Some Important Notes Regarding Scripts:

  The following tags must be at the beginning and end of the script:[Script for Search and Replace] and [End of Search and Replace Script].

  Search strings can be entered on the next line after a [Search] tag.  To enter the Regular Expression, Case Sensitive off (or Insensitive), Whole Word Only and Binary Mode, you must use the /x /i /w /b flags respectively (see above).  The flags are case insensitive.  This is similar to the flags for Command Line Parameters.

  Replace strings can be entered on the next line after a [Replace] tag.  You can only use the /b flag for Binary Mode with this tag (see above) since all other tags are specified on the Search field.

  Path and mask strings can be entered on the next line after a [Path] tag.  No flags can be used with this tag.  The mask string must be entered right after the path string and a \ character is expected between them.  For example c:\*.ini will use Path C:\ and Mask *.ini.  If you turn on the Search Subdirectories box on the main window, all INI files on the C: drive will then be processed.

  Please note:  You can enter Search strings only, both Search and Replace strings, Path and mask strings only, or all the fields in a script.  You can also override some of the values from the main window by entering new Search and Replace strings or new Path and Mask strings.  As new versions come out, more functionality will be added in this area.

  When a script is active, the Search, Replace, File Mask, and Path fields in the Search and Replace main window will change to reflect the script in use.  For example, given a script named, example.srs, which only has settings for a search string, the Search field in the main window will change to read "Use Script file: d:\example.srs".  If example.srs also involved a replace string and a file mask, the Replace and File Mask fields would also change to read, "Use Script file: d:\example.srs".


Script Editor
Script Editor Graphic View


P_SCRIPT_SEARCH
Search String:  Enter the string to search for in this field.  Selecting a row in the Search/Replace List will display the information for that row and allow you to edit it.  To create Binary Mode search, activate the Binary Mode dialog via the [image] button.  If you create a Binary search, the string, "Binary mode -->>", is displayed in the search string area.  When you are done with this field, the Replace string, the Case Sensitive, Match Whole Word, & Regular Expression settings, click on the Search/Replace Apply Button to save the information to your script.

Note that in the current example, the highlighted Search/Replace list row makes use of Regular Expression search using the * operator.


P_SCRIPT_REPLACE
Replace String:  Enter the string to search for in this field.  Selecting a row in the Search/Replace List will display the Search and Replace strings for that row and allow you to edit it.  To create Binary Mode replacements, activate the Binary Mode dialog via the [image] button.  If you create a Binary replacement, the string, "Binary mode -->>", is displayed in the replace string area.  When you are done with this field, the Replace string, the Case Sensitive, Match Whole Word, & Regular Expression settings, click on the Search/Replace Apply Button to save the information to your script.

Note that in the current example, the highlighted Search/Replace list row makes use of Regular Expression replacement using the %1 operator to include the search results yielded by the * search operator (see the Search String) in the replacements.


P_SCRIPT_SRLIST
Search/Replace List:  The list of Search/Replace combinations established for the current script.  Two assignments are listed here.  To change an existing assignment, highlight it in the Search/Replace list, make changes to either the Search or Replace lines, and click on Apply.  Note that as modeled in the example here, a binary operation is reflected by the phrase "Binary Mode ->>" for the second search string.


P_SCRIPT_CASE
Case Sensitive Field:  Check this if you want the search to be case sensitive.  Uncheck it if you want to search regardless of case.  To save the information for the current row when you are done, click the Search/Replace Apply Button.


P_SCRIPT_WHOLE
Match Whole Word Field:  Note that in this example, this field is not available because the Regular Expression field is checked.  If you are not using a Regular Expression Search/Replace, check this field if you want to look for the exact word or phrase specified (enclosed by whitespace).  For example, if this option is on and you look for Window, the program will find it in the phrase ...use the Window menu... but not in the phrase ...Windows 95....  If this option is not checked, both occurrences will be found.  To save the information for the current row when you are done, click the Search/Replace Apply Button.


P_SCRIPT_REGEXP
Regular Expression Field:  Check this field if you want to use a regular expression.  Case sensitive and binary mode can be used in conjunction with this type of search.  See Regular Expressions for more information on the syntax supported.  To save the information for the current row when you are done, click the Search/Replace Apply Button.


P_SCRIPT_BINARY
Search/Replace Strings Binary Mode Buttons:  Click these buttons to activate the Binary Mode dialog for the respective Search or Replace strings  You can use the Binary Mode dialog to create searches that span multiple lines or to insert special characters for the Search field.  When you are done creating the string, "Binary mode -->>", is displayed in the search string area.   Note that to double check your entry or make changes, click the button again.  Be sure to click the Search/Replace Apply Button to enter your changes into the current script.


P_SCRIPT_APPLY
Search/Replace List Apply Button:  Click this button to save the information for the currently selected search/replace row.


P_SCRIPT_REMOVE
Search/Replace List Remove Button:  Click this button to delete the information for the currently selected search/replace row.


P_SCRIPT_REMOVEALL
Search/Replace List Remove All Button:  Click this button to remove all the existing Search/Replace combinations.  For example, if you wanted to start a new script, remove all the current search/replace assignments by clicking here.


P_SCRIPT_MOVEUP
Search/Replace List Move Up Button:  Click this button to move the information for the currently selected row up by one row.


P_SCRIPT_MOVEDOWN
Search/Replace List Move Down Button:  Click this button to move the information for the currently selected row up by one row.


P_SCRIPT_INSERT
Search/Replace List Insert Button:  Click this button to insert a new Search/Replace row above the currently selected row.


P_SCRIPT_FMASK
File Mask field:  One or more include &/or exclude search masks for search files.  The masks are those used in the DOS dir command (e.g., *.*;*.txt;*.doc;*.??1).  More than one mask can be specified by using a semicolon separator (see example above).  Exclude masks use the ~ character to denote a mask NOT to search (e.g., *.*;~*.swp;~*.exe;~*.dll).  To specify a ~ as part of the file mask, use \~ (ie *.*;\~*.tmp).  To save the information for the current row when you are done, click Path/Mask Apply Button.


P_SCRIPT_FPATH
Path field:  This is the path for the search/replace that is currently highlighted in the Search/Replace list (if any are present).  You may type it by hand or navigate to it by using the Browse button below.  Be sure to click on the File/Path Apply button to save your choice to the current script.


P_SCRIPT_FBROWSE
Path/Mask Browse Button:  Click to here to select the path where files to search reside.  The Search and Replace select path browser will be displayed to allow you to visually select the path.  If the Path field currently contains a valid path, it will be your starting path in the dialog.  Otherwise, the current path will be used.


P_SCRIPT_FAPPLY
Path/Mask List Apply Button:  Click this button to save the information for the currently selected row.  If you are making a path/mask new assignment, be sure to click here to apply/add the assignment to the list.


P_SCRIPT_FREMOVE
Path/Mask List Remove Button:  Click this button to delete the information for the currently selected row.


P_SCRIPT_FREMOVEALL
Path/Mask List Remove All Button:  Click this button to remove all the Path/Mask rows.  For example, if you wanted to start a new script, remove all the path/mask assignments by clicking here.


P_SCRIPT_FUP
Path/Mask List Move Up Button:  Click here button to move the information for the currently selected row in the Path/Mask list up by one row.


P_SCRIPT_FDOWN
Path/Mask List Move Down Button:  Click this button to move the information for the currently selected row down by one row.


P_SCRIPT_FINSERT
Path/Mask List Insert Button:  Click this to insert a new Search/Replace row above the currently selected row.  Note that depending on the focus in the Search/Replace list area, clicking here may affect the Search/Replace list.  If you want to insert an additional path and not disturb already established Search/Replacement/Path/Mask combos, first move the focus in the Search/Replace list off exiting items by either: a) clicking the Search/Replace Insert button (the Insert button in the upper ½ of the Script Editor) to create a blank Search/Replace item or b) click anywhere in the Search/Replace List area below the last item in the list.


P_SCRIPT_FPATHLIST
Path/Mask List:  The list of path/mask combinations established for the current script.  Two assignments are listed here.  To change an existing assignment, highlight it in the path/mask list, make changes on the File Mask(s) or Path lines, and click on Apply.


P_SCRIPT_FSAVE
Save As Button:  Click this button to save the created/modified script to disk via a standard Save As dialog.


P_SCRIPT_FLOAD
Load Button:  Click this button to load a script from disk for editing or using Search, Search and Replace, Touch or File Find.


P_SCRIPT_FUSE
Use Script Button:  Click this button to use the script for Search, Search and Replace, Touch or File Find.  You can override several of the script settings in the main window (see Scripts for details).


P_SCRIPT_FCANCEL
Cancel Button:  Exits the dialog without using the script settings.  If you made changes to a script, a confirmation box asks you whether you want to save the information.


P_SCRIPT_HELP
Help Button:  Activates the help topic for the Script Editor.


Regular Expression Support

You can use Regular Expressions for advanced searches, where the Search String follows a rule and is not always exactly the same.  A "special character operator" is a symbol that controls the search and "an expression" is any combination of characters and operators that specifies a pattern.  Regular Expressions can also be used in replacements.  You should note that there are some differences between the operators for Regular Expression search strings and their counterpart replacement strings.

Regular expressions are supported using a subset of the UNIX grep notation for Searching and DOS style Batch file input parameter notation, with some extensions for Replacing.

Using the case sensitive flag and binary mode strings are supported.

Note:  The major differences between the Search and Replace and egrep regular expressions are:

. operator is not supported

*+?! operator must precede an expression enclosed by () or [] (such as *[123] or +(Windows)).  Otherwise, the operator is assumed to match any/all characters from beginning of line or to the end of the line.

See Regular Expression Search Operators for details on conducting searches using regular expressions.  This section includes details on the Match Operators, Sub-Expression Operators, and an example Complex Searches.

See Regular Expression Replacement Operators for details on using regular expressions in replacement operations, including an example Complex Search and Replacement.

Finally, see the section on Regular Expression Examples for some examples on using regular expressions in search and replacement operations.


Regular Expression Search Operators

Described below are the Regular Expression Match Operators and the Regular Expression Sub-Expression Operators.  An example of a complex search using Regular Expressions is also provided.

See Regular Expression Replacement Operators and  Regular Expression Examples for further information and example syntax.

Important Note:  The following characters must be preceded by a \ character to be interpreted as a literal in a search using regular expressions:

- + * ? ( ) [ ] \ | $ ^ !

For example, to search for the \ character, it must be must be doubled (\\) for it to be matched correctly when using Regular Expressions.  The characters that must be preceded by a \ in order to be interpreted as literal characters are also described below.  You should also note that the regular expression replacement literals involve a different set of characters.

Regular Expression Match Operators

*	Zero or more expressions enclosed in () or can be used by itself (see below).  This operator is meant to be used around strings.  Entering several expressions in a row containing * should be carefully done to avoid overlapping characters which can produce unpredictable matches.  A list of characters to match can be specified (Windows *[0-9] will match Windows 95).  E.g., *(is) will match zero or more strings such as: is, isis. This operator can also be used to match all characters between two strings,. e.g., *(is) will match zero or more strings such as: is, isis. Note: using the * operator at the beginning of the line will match all characters from the start of the line and at the end, to the end of the line.  You can match characters between two or more strings (up to 4096 characters (4K) apart) by specifying a range after the * operator. E.g., Windows*[\0-ÿ]95 will match up to 4096 characters (across several lines) between Windows and 95.
+	One or more expressions enclosed in ().  E.g.,  +(is) will match one or more strings such as: is, isis.
?	Exactly one expression enclosed in () or any one character. E.g., ?(is) will match the string is or si This operator can also be used to match any character between two strings or before or after a string.  This is the main use for this operator.  E.g.,  Win?95 will match Win 1995, Win-95, Win/95 etc. Note: Using this operator by itself will match every character in a file one at a time and should be avoided.
!	Does not match if the expression is found.  E.g.,  !(a-c)at will match the string mat, rat or fat but not bat or cat. Another use is to look for a string that doesnt contain an expression.  E.g.,  !(Windows )95 will find 95 in 1995 but not in Windows 95
^	An expression that starts at the beginning of a line.  E.g.,  ^the finds the at the beginning of a line and The if case sensitive is turned off.
$	An expression that ends at the end of a line.  E.g.,  end$ finds end when its the last string on a line.
Regular Expression Sub-Expression Operators

[ ]	Any one character entered between the brackets will be matched.  Ranges are allowed by using the a-z notation.  The [] operator can be used after a ?* + operator to modify the range matched by that operator.  E.g.,  *[0-9] will match: 234907, 5795, or  an empty string). [niewW] will match one or more strings such as: Win, new, win. [a-z] will match any lower case strings if case sensitive and any words if not case sensitive.   Note: You can also enter [a-zA-Z0-9\-_] i.e., multiple ranges and the - character itself preceded by a \.
( )	Denotes one or more sub-expression.  You can specify matching an expression or another by using the | operator.  E.g.,  Win( 95|dows 95) will match strings such as: Windows 95  and Win 95.
Special Regular Expression Search Characters (Literals)

- + * ? ( ) [ ] \ | $ ^ !	If you wish to search for any of these characters, they must be preceded by the \ character to be interpreted as a literal in a search.
Complex Searches Using Regular Expressions

The above mentioned operators can be combined to produce searches such as:

?include (<|\[)[a-z0-9_].h*(p)+[\]>]	Will match: #include [stdafx.h] #include <dos.h> #include [my_include.hpp] #include [sr32.h] etc.


Regular Expression Replacement Operators

The operators matches can be replaced with nothing (removed), the case of the text matched can be changed or they can be left intact.  All operators may match some strings and therefore all should be accounted for in the replace expression.

See Regular Expression Search Operators and  Regular Expression Examples for further information and example syntax.

Important Note:  The following special replacement characters must be preceded by a \ to be interpreted as a literal in a replace:

% \ < >

For example, to replace the \ character, it must be must be doubled (\\) for it to be replaced correctly when using Regular Expressions.  The characters that must be preceded by a \ in order to be interpreted as literal characters are also described below.  You should also note that the regular expression search literals involve a different set of characters.

Regular Expression Replacement Match Operators

%n	%1 will use the first expression in the search string.  For example,
	given the search string:	?include (<|\[)[a-z0-9_].h*(p)+[\]>]
	and the replace string:	%1exclude [%3>.H%4>]
	The results might be:
	#include [stdafx.h]	=>	#exclude [STDAFX.H]
	#include <dos.h>	=>	#exclude [DOS.H]
	#include [my_include.hpp]	=>	#exclude [MY_INCLUDE.HPP]
	#include [sr32.h]	=>	#exclude [SR32.H]
	Note that in this example: %1  - ? %2  - (<|\[) %3 -  [a-z0-9_] %4 -  *(p) %5 - +[\]>] These parameters can be used several times, omitted or used in any order.
<	Make lower case operator.  To be used in conjunction with %n: %1< will replace the original first matched expression with its lower case version.
>	Make upper case operator.  To be used in conjunction with %n: %1> will replace the original first matched expression with its upper case version.
Special Regular Expression Replacement Characters (Literals)

% \ < >	If you wish to replace any of these characters, they must be preceded by the \ character to be interpreted as a literal in a replacement.


Regular Expression Replacement Literals

% \ < > must be preceded by the \ character to be interpreted as literals in a regular expression replacement.


Regular Expression Search Literals

- + * ? ( ) [ ] \ | $ ^ !  must be preceded by the \ character to be interpreted as literals in a regular expression search.


Regular Expression Examples

Note: For all the replace operations, you can see the result of the operation by making sure that in the Options dialog the Prompt on All radio button is selected (in Search and Replace Options group).

Three sets of examples are available:

Some "How-To" Regular Expression Search Examples

Regular Expression Search Examples

Regular Expression Search and Replace Examples

You should also review the help sections on Regular Expression Search Operators  and Regular Expression Replacement Operators for further examples.


How-To Regular Expression Search Examples
Some "How-To" Regular Expression Search Examples

Below are some basic examples of regular expression operators and their outcomes.

What to Match	Operator	Examples
Any single character	?	g?t finds get, got, gut
Any string of characters (one or more)	+	w+e finds wide, white, write but not we
Any string of characters (or none)	*	w*e finds wide, white, write and we
One of the specified characters	[]	g[eo]t finds get and got but not gut
One of the characters in a range	[-]	[b-p]at finds bat, cat, fat, hat, mat but not rat or sat
One expression or another	(|)	W(in|indows) will find Win or Windows
One or more expressions	+()	+(at) will find atat in catatonic and at in battle
Two strings nearby (perhaps on different lines)	*[]	the*[\0-ÿ]first will match the first and the (line feed... more text) very first You can enter special characters in the Binary Mode dialog (the [image] button next to the Search and Replace Strings) and use them with regular expressions.
A string that doesnt start with an expression	!()	!(http): will match : in following: but not in http://www.funduc.com
One of the characters not in a range	![-]	[b-p]at finds bat, cat, fat, hat, mat but not rat or sat
An expression at the beginning of a line	^	^the finds the at the beginning of a line and The if case sensitive is turned off.t
An expression at the end of a line	$	end$ finds end when its the last string on a line.


Regular Expression Search Examples

Below are some additional examples of regular expression search operations.  You may also wish to see additional Regular Expression Search Examples and the section on Regular Expression Search and Replace Examples for some other models.

Search String	Will Match
[on]	non, no, on
\[	[
+[a-z]	abcdefghijklomopqrstuvwxyz if used with Case Sensitive off, it will also match ABCDEFGHIJKLMNOPQRSTUVWXYZ
[a-zAZÀ-ÿ]	matches the same as the example directly above (regardless of case sensitive flag) and also all other special characters for Western European languages.  See the Binary Mode dialog for the order of those characters in the ASCII table.
+(one|two|three)	one, onetwo, twothree
?(one|two|three)	one,two,three
Windows*[\0-ÿ]95	Will match up to 512 characters (on several lines) between Windows and 95.
All * replaces	all the replaces (the * character matches all chars on the same line unless a [] expression overrides that - see above)
/**[\0-ÿ]*/	Will match C style comments on several lines if necessary (up to 512 characters).
01*[0-9].htm	01346.htm, 01.htm, 016965.htm
*[ab]c	c, abc, bac, abbc, bbac


Regular Expression Search and Replace Examples

Below are some examples of Regular Expression Replacement operations.  To see more example tactics for setting up searches using regular expressions, see the sections on Some "How-To" Regular Expression Search Examples and Regular Expression Search Examples.

Search String	Replace String	Effect
*.*	%1>.%2>	c:\windows\win.ini  => C:\WINDOWS\WIN.INI
+[a-z]	%1>	Windows  => WINDOWS
7*.htm	5%1.htm	711.htm => 511.htm 7days.htm => 5days.htm
[253]7[832].htm	%15%2.htm	3572.htm => 3552.htm
*[253]7[832].htm	%15%2.htm	72.htm => 52.htm
(homepage|index).htm	%11.htm	homepage.htm => homepage1.htm index.htm => index1.htm
+(12)[0-9]	%1%2a	12532 => 12532a 1212753 => 1212753a
???*(d|m).htm	%1%2%3d1.htm	card.htm => card1.htm form.htm => form1.htm
?(Windows)	OS/2	Windows => OS/2    (just kidding)


Touch Files Dialog

"Touch" allows you to change the time & date stamp of a file.  The steps are straightforward: 1) Enter (or select from combo boxes) one or more file masks and a path.  2) Select "Touch" from the Actions Menu or the Touch button.  3) The Touch dialog will prompt you for a date and time to use for all the files.

Important Note:  Touch operates on all files described by the filemask and path.  Touch does not distinquish files by the search or replace fields.

Details on the Touch Dialog fields:

Date field:  Select the date to be used (in format mm/dd/yy or mm/dd/yyyy).

Time fields:  Select the time to be used (in format hh or hh:mm or hh:mm:ss) and AM or PM (do not use military time).

OK button:  The dates and times will be set for all the files found using the file masks specified.

Cancel button:  No files will be touched.

Update button:  The date and time fields will be refreshed using the current date and time according to the PC's clock.


Binary Mode (special characters or multiple lines) dialog
Binary Mode Dialog

The binary mode dialog is activated by the [image] buttons next to the Search and Replace string fields in the main window and in the Script Editor.  This dialog is used to enter multiple lines for search and replace strings and binary characters (such as tabs, special characters, etc).  See Using Special Characters for more details.  To Search/Replace line feeds, use \r\n and for TAB characters, use \t.  If you need to use the \ character (e.g., in a path), you must double it (\\).

Search/Replace Block field:  You can type, paste (using paste button or Ctrl+V) text already in the Clipboard or use the Binary Codes list (below) to add characters to this field.  Note that you can perform the usual editing operations in this field by using the keyboard as follows:

Copy - Ctrl+C

Paste - Ctrl+V

Undo - Ctrl+Z (last operation only)

Special Operations group (Search field only):  You can instruct Search and Replace to prepend (add to the beginning of the file) or append (add at the end of the file) a block of text to each file processed or to simply use the Search String entered.  You can confirm replacing the same way you can with regular search strings.

Binary Codes fields:  This List allows you to add special characters to the Search/Replace field by either double-clicking or selecting an item and then clicking the Add Code button

Add Code button:  The Binary Code specified will be added to the Search/Replace Block field.

OK button:  The Search/Replace field will be used as specified.

Cancel button:  No changes are made.

Paste Text:  The text currently in the clipboard is pasted in the Search/Replace Block field.  If anything is selected in the Search/Replace field, the selection will be replaced by the text pasted.  If no text is in the clipboard, nothing will happen.

Double all \s button:  The \ character is used to input special (binary) characters.  To use a \ character (for example in a path), you must enter it as \\.  This button will facilitate that by parsing the current text entered in the Search/Replace block field and changing all \s to \\.


Special (binary) characters: Using
Using Special Characters

You can process (either Search for or Search and Replace) binary characters, line feeds (in DOS CR LF combinations - \r\n), tabs, etc by using the Binary Mode dialog which is available from the [image] buttons next to the Search and Replace String fields in the main window and the Script Editor.

The most important special characters are \r\n (the DOS linefeed sequence), \r (the MAC linefeed sequence), \n (the UNIX linefeed sequence), \t (the TAB character) and \\ (note the \ characters MUST be doubled for the parser to work correctly).  Since you can use the Binary Mode dialog with Regular  Expressions, see the Regular Expression Support for additional special characters.

Here is the list of Special characters:

Representation	Description
\0x00	Character 0
\0x01	Character 1
\0x02	Character 2
\0x03	Character 3
\0x04	Character 4
\0x05	Character 5
\0x06	Character 6
\a	ASCII Bell characters
\b	ASCII Backspace character
\t	TAB
\n	Line Feed (See Note)
\v	Vertical TAB
\f	Form Feed
\r	Carriage Return (See Note)
\0x0e	Character 14
\0x0f	Character 15
\0x10	Character 16
\0x11	Character 17
\0x12	Character 18
\0x13	Character 19
\0x14	Character 20
0x\15	Character 21
0x\16	Character 22
\0x17	Character 23
\0x18	Character 24
\0x19	Character 25
\0x1a	Character 26
\0x1b	Character 27 (ESC char)
\0x1c	Character 28
\0x1d	Character 29
\0x1e	Character 30
\0x1f	Character 31
	(space)
!	!
\"	"
#	#
$	$
%	%
&	&
\'	'
(	(
)	)
*	*
+	+
,	,
-	-
.	.
/	/
0	0
1	1
2	2
3	3
4	4
5	5
6	6
7	7
8	8
9	9
:	:
;	;
<	<
=	=
>	>
\?	?
@	@
A	A
B	B
C	C
D	D
E	E
F	F
G	G
H	H
I	I
J	J
K	K
L	L
M	M
N	N
O	O
P	P
Q	Q
R	R
S	S
T	T
U	U
V	V
W	W
X	X
Y	Y
Z	Z
[	[
\\	\
]	]
^	^
_	_
`	`
a	a
b	b
c	c
d	d
e	e
f	f
g	g
h	h
I	I
j	j
k	k
l	l
m	m
n	n
o	o
p	p
q	q
r	r
s	s
t	t
u	u
v	v
w	w
x	x
y	y
z	z
{	{
|	|
}	}
~	~
\0x7f	Character 127
\0x80	Character 128
\0x81	Character 129
\0x82	Character 130
\0x83	Character 131
\0x84	Character 132
\0x85	Character 133
\0x86	Character 134
\0x87	Character 135
\0x88	Character 136
\0x89	Character 137
\0x8a	Character 138
\0x8b	Character 139
\0x8c	Character 140
\0x8d	Character 141
\0x8e	Character 142
\0x8f	Character 143
\0x90	Character 144
\0x91	Character 145
\0x92	Character 146
\0x93	Character 147
\0x94	Character 148
\0x95	Character 149
\0x96	Character 150
\0x97	Character 151
\0x98	Character 152
\0x99	Character 153
\0x9a	Character 154
\0x9b	Character 155
\0x9c	Character 156
\0x9d	Character 157
\0x9e	Character 158
\0x9f	Character 159
\0xa0	Character 160
\0xa1	Character 161
\0xa2	¢
\0xa3	£
\0xa4	¤
\0xa5	¥
\0xa6	¦
\0xa7	§
\0xa8	¨
\0xa9	©
\0xaa	ª
\0xab	«
\0xac	¬
\0xad	­
\0xae	®
\0xaf	¯
\0xb0	°
\0xb1	±
\0xb2	²
\0xb3	³
\0xb4	´
\0xb5	µ
\0xb6	¶
\0xb7	·
\0xb8	¸
\0xb9	¹
\0xba	º
\0xbb	»
\0xbc	¼
\0xbd	½
\0xbe	¾
\0xbf	¿
À	À
Á	Á
Â	Â
Ã	Ã
Ä	Ä
Å	Å
Æ	Æ
Ç	Ç
È	È
É	É
Ê	Ê
Ë	Ë
Ì	Ì
Í	Í
Î	Î
Ï	Ï
Ð	Ð
Ñ	Ñ
Ò	Ò
Ó	Ó
Ô	Ô
Õ	Õ
Ö	Ö
\xd7	Character 215
Ø	Ø
Ù	Ù
Ú	Ú
Û	Û
Ü	Ü
Ý	Ý
Þ	Þ
ß	ß
à	à
á	á
â	â
ã	ã
ä	ä
å	å
æ	æ
ç	ç
è	è
é	é
ê	ê
ë	ë
ì	ì
í	í
î	î
ï	ï
ð	ð
ñ	ñ
ò	ò
ó	ó
ô	ô
õ	õ
ö	ö
0xf7	Character 247
ø	ø
ù	ù
ú	ú
û	û
ü	ü
ý	ý
þ	þ
ÿ	ÿ


LFCR
Note: In DOS \r\n constitute a line feed while in UNIX \n alone is used.


Command Line Parameters

For the Windows 95/NT version, command -line parameters can be used as follows:

/I	Case Insensitive (note that this option is the reverse of what the user interface shows).  If not specified, Case Sensitive is assumed.
/x	Regular Expression.  If not specified, it is assumed off.
/d	Search Subdirectories.  If not specified, it is assumed off.
/w	Match Whole Word (ignored if Regular Expression is used).  If not specified, it is assumed off.
/r	Perform a  replace (to be used with Script see below).
/t	Perform a Touch on the files specified.
/sstring	Search String to use (automatically starts a Search).  If the string contains spaces or / characters, enclose it in double quotes.
/pC:\*.ini;*,txt	Path to search with mask(s) appended after the \.  If no path or masks are specified, the last program default is used.
/oresults.txt	Output file to send the search results to.  If not specified, the last program default is used (this is specified in the Options dialog).
/cscript.srs	Script file to use.  If Replace or Touch is not specified(see above), a Search is performed.
/q	Quit after operation.  Window will close after the operation is completed.

Note: The flags can be upper or lower case.  The /i /x /d /w flags can be used separately or together in any order.  Here are some examples:

SR32 /oc:\dump.txt /sWindows /pc:\windows\*.ini /id

SR32 /I /D /oc:\dump.txt /SWindows /pc:\windows\*.ini /id


Replace dialog
Replace Confirmation Dialog

This window allows several options for replacing the string found:

Replace This button:  This occurrence of the found string will be replaced.

Replace Rest In File button:  All occurrences of the found string in the file currently processed will be replaced.

Replace Rest In Directory button:  All occurrences of the found string in the files in the current files directory will be replaced.

Replace All Remaining button:  All occurrences of the found string in the file currently processed and the files processed after that will be replaced.  No more prompts will be displayed until the end of the operation.

Skip This button:  This occurrence of the found string will not be replaced.

Skip Rest of File button:  All remaining occurrences of the found string in the file currently processed (including the current one) will not be replaced.

Skip Rest In Directory button:  All occurrences of the found string in the files in the current files directory processed (including the current one) will not be replaced.

Cancel Remaining button:  All occurrences of the found string in the file currently processed and the files processed after that will not be replaced.

Found String List:  The list box containing the Search Results allows you to double-click an item to  display the View Context dialog (if double-clicking on a line where the search string is displayed) or Shell the executable associated with it (in File Manager).  You can also use the right mouse button to display a menu or use the Ctrl+C key to copy the list box contents to the Clipboard.  To change the colors and many other options, click the Options button.


Search and Replace About Box

This window contains system and copyright information.  Click the Ordering Info button for Ordering Information or the License Info button for License Information.

For customer support, contact support@funduc.com.


About Search and Replace

        Search and Replace for Windows

Search and Replace
Version 2.83
Copyright © 1995-1997 Funduc Software, Inc.
All Rights Reserved
http://www.funduc.com

See Ordering Information for details on how to purchase Search and Replace for Windows or write us at info@funduc.com.  See License Information for details about licensing.  For customer support, contact support@funduc.com or visit our web site at http://www.funduc.com for FAQs & program updates.  Also check our web site for product information, trialware & freeware downloads of our other award winning software products.


Product Information
FUNDUC SOFTWARE

  Product Information

      Directory Toolkit for Windows 95/NT

Directory Toolkit for Windows 95/NT is an application that provides features missing from Windows 95 and Windows NT 4.0 or higher.  Directory Toolkit allows files in two directories to be compared, it provides file renaming, and it copies, moves and deletes multiple files using wildcards while preserving long file names (the DOS commands don't).  It also Decodes and Encodes files, splits/concatenates files to/from diskettes, and sorts directories.  Directory Toolkit has Explorer compatible OLE drag and Drop and it can open files and launch applications.  The main features are listed below.

Directory Toolkit for Windows 95/NT has been a winner of the WUGNET® Best Choice Shareware award.

      Search & Replace for Windows

Search and Replace for Windows is our award winning utility is loved by programmers, webmasters, and novice computer users alike.  If you need to find and replace text, or just find text, this utility is a must have.

Search and Replace looks through multiple files (specified by one or more masks) for a string and can also replace it with another string.  It can also search subdirectories and ZIP files and do case sensitive or insensitive searches.  Replacing a string can be made one string at a time, one file at a time or all at once (no prompts).  Some replaces may be skipped or all the rest of the occurrences can be replaced for the rest of a file.

Search and Replace has received awards from WUGNET (Windows User Group Net), - Pick of the Week for August 11 1996;  Windows Magazine - Superior Shareware in the August 1996 issue;  ZD-NET - rated 4 stars;  TUCOWS - rated 5 Cows.

      Patch Creator

Patch Creator is a application for creating your own patches for updating registered versions of your software with this GUI program.  It can create 16 or 32 bit patches, require password or not compressed or not and is self-contained.  Files on users' machines can be updated from a specific version, added regardless of existing version, removed or renamed.  Ideal for distribution needs and for shareware authors.  Demo version creates patches without passwords.

Decode/Encode DLLs

Decode/Encode DLLs integrate auto-decoding of UUENCODED, Base64(MIME), Binhex, XXENCODED, user table encoded and encoding(UUENCODED or Base64/MIME) in your Windows 3.1x, 95 or NT application.  16 and 32 bit DLLs are included, test programs are provided for C/C++ (MFC) and Visual Basic. One time fee provides a registered copy for royalty-free distribution with your applications and one year free customer support.

      Decode Windows 95 Shell Extension (freeware)

Decode Shell Extension (v2.3) now supports multiple attachments, multi-part files (already concatenated), XXENCODED and User (table) encoded files in addition to UUENCODED, Base64(MIME) and BinHex (Mac format) files.

Decode allows you to decode a UUENCODED, XXENCODED, BinHex or Base64(MIME) file by simply right-clicking on it in the Explorer and selecting Decode from the menu.

      HexView for Windows 95/NT (freeware)

HexView is a multiple document Hexadecimal viewer that can display, print, and print preview any file as a hex dump.  It is intended as a supplement for Search and Replace for Windows, however, it is a standalone app and does not require Search and Replace.

      INI to Registry (freeware)

INI to Registry will load the contents of any INI file and and transfer it into the Windows 95/NT registry.  That way programs that previously used INI files can read the old data from the registry.  The INI to Registry utility was orginally developed to allow users of Search and Replace to upgrade to versions of the software greater than 2.41 (for Windows 95 and NT) without losing their history.  The program code is available for purchase.


Confirmation Dialog

This window allows you to confirm whether or not you want to perform an operation (such as replace Read-Only files).  A Yes To All button allows you to avoid being prompted again.  The Cancel button will Cancel the entire remaining replaces.


View Context

This window allows you to view and change (in the registered version) the lines around where the search string was found.

The number of lines before and after is configurable in the Options dialog (see the Number of Lines to View field).

Note that you can perform the usual editing operations in this field by using the keyboard as follows:

Copy - Ctrl+C

Paste - Ctrl+V

Undo - Ctrl+Z (last operation only)

Save button:  The changes will be made (registered version only). If the file is in a ZIP file, it is extracted to a subdirectory of the path specified in Options.  If you edit it, you must then update the ZIP file since it is NOT automatically updated.

Cancel button:  The changes will not be made.

Page Up button:  Will display the block of lines above the current block.

Page Down button:  Will display the block of lines above the current block.


Ordering Information
FUNDUC SOFTWARE

Purchasing & Ordering Search and Replace for Windows

As part of the registration, you will also receive free updates and customer support (by E-MAIL) for six months.  Updates are sent to registered customers quarterly.  They incorporate your suggestions so please send them.  If you have problems receiving the program or need customer support, contact us directly by E-MAIL at support@funduc.com.  Quantity discounts are listed on the WWW at: http://www.funduc.com.

  Credit Card Registration:  Several routes are available…

  Secure Internet Transaction: If you have a secure Web browser such as Netscape or Internet Explorer, you may register by credit card via a secure Web transaction from our web site at:  http://www.funduc.com.

  Fax Registration: You may register using a credit card via fax.  Open and print the fax form and fax the completed order to (813) 526-2924.  You may also use edit and print the file ORDER.TXT in the Search and Replace subdirectory.  The cost through this option is $25/single user + $3 to $5 S&H if you want a diskette mailed (E-MAIL delivery is free).  Please allow 7-10 days for postal orders to reach you, then contact us by E-MAIL at support@funduc.com if you did not receive the program.  E-MAIL deliveries are sent within 2 business days.  E-MAIL deliveries require that your mail system can receive MIME attachments.

  Phone Registration: You can call (800) 500-0326 or (352) 315-6330 to order using a credit card.  The cost through this option is $25/single user + $3 to $5 S&H if you want a diskette mailed (E-MAIL delivery is free).  Please allow 7-10 days for postal mail to reach you, then contact us by E-MAIL at support@funduc.com if you did not receive the program.  E-MAIL deliveries are sent within 2 business days.  E-MAIL deliveries require that your mail system can receive MIME attachments.

  Ordering by check:  To order by check, please open and print the order form.  You may also use edit and print the file ORDER.TXT in the Search and Replace subdirectory.  Mail the completed form and a check for $20 (+$3 - $5 if you want a diskette mailed) to Funduc Software Inc., P.O. Box 530904 Livonia, MI 48153.   Please allow 7-10 days for mail to reach you, then contact us by E-MAIL at support@funduc.com if you did not receive the program.  Payments must be in US dollars drawn on a US bank or international postal money order in US dollars.

  CompuServe Registration:  CompuServe subscribers may register by typing GO SWREG and using the Registration ID 7964.  The cost for CompuServe orders is $23/user due to CompuServe charges.  CompuServe orders are filled by E-MAIL within 24-48 hours, regardless of delivery method selected.  Therefore please check your CompuServe mail a day or two after placing your order.


Search and Replace Order Form
Search and Replace for Windows Mail Order

FUNDUC SOFTWARE, Inc.

Search and Replace for Windows Mail Order (Ver 2.83)

To place an order by mail, complete the form & a check and mail it to:

Funduc Software Inc.
P.O. Box 530904
Livonia,  MI 48153

Note:  Payments must be in US dollars drawn on a US bank or international postal money order in US dollars.

License	Price ($US)	Quantity	Amount
1 to 9 computers	$ 20.00	_______	$_________
10 to 24 computers	$ 18.50	_______	$_________
25 to 49 computers	$ 17.50	_______	$_________
50+ computers	$ 15.00	_______	$_________
	Michigan residents add 6% sales tax	$_________
Preferred Shipping Method
	Mail 3.5 disk (US) $3 S&H	$_________
	Mail 3.5 disk (overseas) $5 S&H	$_________
	E-MAIL (Free)	$_______0_
		TOTAL PAYMENT	$_________
Your Name:	__________________________________
Street Address:	__________________________________
Street Address:	__________________________________
City, State, Zip:	__________________________________
Country:	__________________
Day Phone Number:	_______________________
Eve Phone Number:	_______________________
Fax Number:	_______________________
E-MAIL Address:	__________________________________
Date:	________________

How did you find out about Search and Replace for Windows?

Comments:


Search and Replace Fax Form
Search and Replace for Windows Fax Order

FUNDUC SOFTWARE, Inc..

Search and Replace for Windows Fax Order (Ver 2.83)

To place an order by fax, print the form and fax it to (813) 526-2924

License	Price ($US)	Quantity	Amount
Single computer	$ 25.00	_______	$_________
2 to 9 computers	$ 23.00	_______	$_________
10 to 24 computers	$ 21.00	_______	$_________
25 to 49 computers	$ 18.00	_______	$_________
50+ computers	$ 15.00	_______	$_________
	Florida residents add 7% sales tax	$_________
Preferred Shipping Method
	Mail 3.5 disk (US) $3 S&H	$_________
	Mail 3.5 disk (overseas) $5 S&H	$_________
	E-MAIL (Free)	$_______0_
		TOTAL PAYMENT	$_________
Credit Card (Check One):	Visa[  ]	MasterCard[  ]
		American Express[  ]	Discover[  ]
Your name as it appears on your card:	_______________________________
Credit Card Number:	__________________________________
Expiration Date:	__________________
Billing Address as it appears on your card:
Street Address:	__________________________________
Street Address:	__________________________________
City, State, Zip:	__________________________________
Country:	__________________
Day Phone Number:	__________________
Eve Phone Number:	_______________________
Fax Number:	_______________________
E-MAIL Address:	__________________________________
Authorized Signature:	____________________________________________
Date:	________________

Comments:


Licensing Information
License Information

Search and Replace for Windows
 Copyright (c) 1995-1997 by Funduc Software Inc.
 All rights reserved.

See Ordering Information for more information on how to purchase Search and Replace.

License Agreement and Warranty Disclaimer

You should carefully read the following terms and conditions before using this software.  Use of this software indicates your acceptance of these terms and conditions.  If you do not agree with them, do not use the software.

Shareware Version

You are hereby licensed to: use the Shareware Version of the software for a 21 day evaluation period; make as many copies of the Shareware version of this software and documentation as you wish; give exact copies of the original Shareware version to anyone; and distribute the Shareware version of the software and documentation in its unmodified form via electronic means.  There is no charge for any of the above.

You are specifically prohibited from charging, or requesting donations, for any such copies, however made; and from distributing the software and/or documentation with other products (commercial or otherwise) without prior written permission.

Unregistered use of Search and Replace after the 21-day evaluation period is in violation of federal copyright laws.

Evaluation and Registration

This is not free software.  This license allows you to use this software for evaluation purposes without charge for a period of 21 days.  If you use this software after the 21 day evaluation period a registration fee is due (see Ordering Information).

Customer support can be obtained by visiting our homepage at http://www.funduc.com or by E-MAIL (support@funduc.com).

One registered copy of Search and Replace may be dedicated to a single person who uses the software on one or more computers or to a single workstation used by multiple people.

You may access the registered version of Search and Replace through a network, provided that you have obtained individual licenses for the software covering all workstations that will access the software through the network.

Governing Law

This agreement shall be governed by the laws of the State of Michigan.

Disclaimer of Warranty

This software and the accompanying files are sold "as is" and without warranties as to performance of merchantability or any other warranties whether expressed or implied.  In particular, there is no warranty for the string Replacing feature.

Good data processing procedure dictates that any program be thoroughly tested with non-critical data before relying on it.  The user must assume the entire risk of using the program.  Any liability of the seller will be limited exclusively to product replacement or refund of purchase price.


Customer Support
Customer Support Information

If you have a question that is not answered in the documentation, there is a FAQ (Frequently Asked Questions) document available on our Web site at: http://www.funduc.com.  If you need further assistance, contact us directly by E-MAIL at support@funduc.com.  Please give as much detail as possible about the operation you want to perform (example lines before and after the replace operation, search and replace strings used, etc).

Registered users are eligible for support and quarterly updates for a period of six months.

Shareware Users: We will do our best to answer your questions, however, please be aware that ongoing support necessitates that you register Search and Replace.

To report a bug, E-MAIL: bugs@funduc.com.

We welcome suggestions and ideas for improving Search and Replace.  If you have a suggestion, please first check the documentation and READ.ME file to make sure they are not already implemented or planned.  If not, drop us a note at support@funduc.com.

For ordering information, please see the section Ordering Information.

Thank you for using Funduc Software products!


Acknowledgements
Acknowledgments

The portion of Search and Replace that searches through ZIP files is based on the work of the Info-Zip group and used with their permission.  Thanks to the entire Info-Zip group, in particular to Jean-loup Gailly, Greg Roelofs, and Mark Adler. If you are interested, you can obtain the Info-Zip code from many sources, including: CompuServe, ibmpro forum; BIX: ibm.pc listings; Internet, ftp.uu.net:/pub/zip.  If you cannot obtain this file from other sources you can send a self-addressed-stamped envelope with a disk to the address in the "About" dialog box.  Also thanks to Ken Webster (kwebster@pen.k12.va.us) for preparation of the help file.


Select Path Dialog Box

The Select Path Dialog provides a convenient way to select and insert a directory into the various "Path" lines.  Use the tab key navigate to topic areas or move your mouse around the screen - it will change to a hand cursor when it is over areas where additional help is available.


Select Path Dialog Directory
You may either type in a specific path or use the mouse in the area below to select the directory where the files you want to view reside.


Select Path Dialog Drive
Select the drive where the files you want to view reside.  The arrow to the right activates a drop down list that displays the available and accessible drives on your system.


Select Path Dialog Navigate
To navigate using the mouse, double click on the folder icons.  The browser display will update accordingly.


Select Path OK
If you click here, the path displayed on the Directory line will be inserted in the respective Path section of the main window.


Select Path Dialog Cancel
Cancel the procedure.  The path will not be changed.


File Open / Select Viewer Dialog Box
File Open/Select Viewer Dialog

File Name:  Select or type the name of the document you want to open. This box lists documents with the filename extension selected in the List Files Of Type box. To see a list of files with a particular extension, type an asterisk (*), a period, and the three-character extension, and then press ENTER. To see files with more than one filename extension, type a semicolon (;), a second asterisk (*), a period, and another three-character extension. For example, if you  want to see all files with the .TXT extension and all files with the .INI extension, type *.txt;*.ini.

List files of Type:  Select the type of files you want to see in the File Name list.

Directories:  Select the directory where the files you want reside.

Drive:  Select the drive where the files you want reside.

OK button:  The file you selected will be used.

Cancel button: The file will not be used.


File Save Dialog

File Name:  To save a document with a new name, in a different file format, or in a different location, type a new filename.  To save a document with an existing filename, select the name in the list or type the current name.

Save files of Type:  Select the type of files you want to see in the File Name list.

Directories:  Select the directory where the files you want to search reside.

Drive:  Select the drive where the files you want to search reside.

OK button:  The file you selected will be used.

Cancel button:  The file will not be used.


Color dialog

Colors are set in the General Options tab under program options.

Basic Colors:  Basic colors is a palette of the preset colors available for your screen.  Click the color you want to use OR use the TAB key to move to the color you want and press the SPACE bar to select it.

Custom Colors:  Custom colors can be set by the user by using the Define Custom Colors Button.  They are selected the same way Basic Colors are.

Define Custom Colors Button:  Will allow you to create your own colors.

OK button:  The changes will not be made.

Cancel button:  The color will not be changed.


Font dialog

Fonts are set in the General Options tab under program options.

Font Field:  The face name of the font used.

Font Style Field:  The available styles vary depending on the Font selected.  The most common are Regular, Italic and Bold.

Font Size Field:  Point size of the font.  You can enter a custom value if you dont see it in the list for some fonts.

Strikeout box:  Check it to select a strikeout font.

Underline box:  Check it to select an underlined font.

Color list:  Select the font color.

Script:  Select the appropriate language script for that font.

OK button:  The changes will not be made.

Cancel button:  The font will not be changed.


No Help Available

No help is available for this area of the window.


No Help Available

No help is available for this message box.


File Masks
File Masks: Include & Exclude Masks

File Masks are file name filters that define which files Search and Replace will operate on.  The masks are those used in the DOS dir command (e.g., *.*;*.txt;*.doc;*.??1).  More than one mask can be specified by using a semicolon separator (see above).  Be sure not have any blank spaces between the semicolon and the masks.

Search and Replace saves your last few file masks.  You can you can find them in the combo box list to the right of the File Mask field.

Include Masks:  These are the masks as outlined above.  For example, to include all files of the filetype .html in a search, you would use the mask *.html.  Of note, if you wanted to also include .htm files, you could use the mask *.htm* or use a semicolon separator and create two masks, *.html;*.htm.

Exclude Masks:  the ~ character denotes a mask NOT to search.  For example, if you wanted to exclude all .exe and .dll files from your search, you would use the mask *.*;~*.exe;*.dll.  Here, all files but .exe and .dll files would be included.  Note the use of the semicolon separators.

If you want to specify the ~ character as an explicit part of a filename, use \~ to denote the literal.  For example, a mask to include the files named ~1.txt and ~2.txt in your search would be \~*.txt.  To create an exclude mask for those files, you would use the mask, ~\~*.txt.


File Masks

File Masks are file name filters that define which files Search and Replace will operate on.  The masks are those used in the DOS dir command (e.g., *.*;*.txt;*.doc;*.??1).  More than one mask can be specified by using a semicolon separator (see above).  Be sure not have any blank spaces between the semicolon and the masks.

Search and Replace saves your last few file masks.  You can you can find them in the combo box list to the right of the File Mask field.

Include Masks:  These are the masks as outlined above.  For example, to include all files of the filetype .html in a search, you would use the mask *.html.  Of note, if you wanted to also include .htm files, you could use the mask *.htm* or use a semicolon separator and create two masks, *.html;*.htm.

Exclude Masks:  the ~ character denotes a mask NOT to search.  For example, if you wanted to exclude all .exe and .dll files from your search, you would use the mask *.*;~*.exe;*.dll.  Here, all files but .exe and .dll files would be included.  Note the use of the semicolon separators.

If you want to specify the ~ character as an explicit part of a filename, use \~ to denote the literal.  For example, a mask to include the files named ~1.txt and ~2.txt in your search would be \~*.txt.  To create an exclude mask for those files, you would use the mask, ~\~*.txt.


Graphic View of Search and Replace - Main Window

Use the tab key navigate to topic areas or move your mouse around the screen - it will change to a hand cursor when it is over areas where additional help is available.  For detailed help, see Search and Replace for Windows Main Window.


P_SSEARCH
Search String

Enter the string to search for in this field or select a previous search string from the combo list.  If you do not enter a Search String, the File Mask and Path fields will be used to execute a File Find, with the results displayed in the Search Results list.

In the screen modeled here, we searched for the string "<body bgcolor="#FFFFFF"" across files of the filetypes *.htm and *.html (the file mask), in the path d:\example.

Note: When a script is active, this field may change to reflect the script in place, e.g., "Use Script file: xxx", where xxx is the name of the script file.  See Scripts for more info.


P_SBINARY
Binary Editor

These buttons activate the Binary Mode Editor for the search & replace string fields.  You use Binary Mode to search or replace across multiple lines or to enter special characters for the search or replace fields.  Note that if you create a string using binary mode input, the string "Binary mode -->>" is displayed on the respective Search &/or Replace string lines.  If you wish to revise or check your entry, click on this button again.  Please see Binary Mode dialog for more information on multiple line and/or special character search / replace strings.

You should also note that if you are doing a Search & Replace operation, it is OK to have one component as a "binary mode" string and the other as a regular string (or even a blank string).


P_SREPLACE
Replace String field

Enter your replacement string in this field or select one from the drop down list to the right.

If you are doing a search-only operation, you can leave this field blank.  It is also OK to have a replacement string here even though you're just doing a search.  For example, the screen modeled here has a replace string "<body bgcolor="#FFFFFFF" entered even though the screen shot is based on a search-only operation.

Note: When a script is active, this field may change to reflect the script in place, e.g., "Use Script file: xxx", where xxx is the name of the script file.  See Scripts for more info.


P_SMASK
File Mask

Include and exclude file masks are the name filters that define which files to search.  The masks are those used in the DOS dir command (e.g., *.*;*.txt;*.doc;*.??1).  More than one mask can be specified by using a semicolon separator (see above).  Be sure not have any blank spaces between the semicolon and the masks.  Exclude masks use the ~ character to denote with files to exclude from your procedure.  For example, to exclude .exe and .dll files and include all other files, you would use the mask *.*;~*.exe;*.dll.  If you have filenames that involve the ~ character, use \~ to distinquish the literal.  For more information, see File Masks.

Note that in the current example, the mask *.htm* will include all files that have a filename suffix ("filetype") involving .htm.  For example, this mask would find the files file.htm, home.html, test.html, or weirdnamedfile.htmltxt.

Note: When a script is active, this field may change to reflect the script in place, e.g., "Use Script file: xxx", where xxx is the name of the script file.  See Scripts for more info.


P_SPATH
Path field:  The path where files to search reside.  You may type it by hand, navigate to it by using the path browser button, or select a previously used path from the combo list.  Note that to search subdirectories under the path, click on the Search Subdirectories checkbox.


P_SCASE
Case Sensitive field:  Check this if you want the search to be case sensitive.  Uncheck it if you want to search regardless of case.  Note that if you want a replacement to be case sensitive, you must define a case sensitive search.


P_SSUBDIR
Search Subdirectories field:  Check this if you want to search all subdirectories under the path you defined.  Note that searching subdirectories will usually slow your search since more files will be processed.  Uncheck it if you just want to search the specified path.


P_SWHOLE
Match Whole Word:  Check this to search for the exact word or phrase specified, meaning, it is enclosed by whitespace.  For example, if this option is on and you look for Window, the program will find it in the phrase ...use the Window menu... but not in the phrase ...Windows 95....  If this option is not checked, both occurrences will be found.


P_SREGEXP
Regular Expression field:  Check this if you want to use a regular expression.  You should note that if you are doing a regular expression operation, the Match Whole Word function is not available.  Case Sensitive and Binary Mode can be used in conjunction with Regular Expression.  See Regular Expression Support for more information on the syntax supported.


P_SDROP
Drop Down Lists:  Search and Replace saves your last few choices in the respective input areas to the left of the selection lists.  Click here to activate the lists.  The number of items saved is configured in Options dialog.


P_SBROWSE
Path Browser:  Click here to activate a path selection dialog.  See Select Path Dialog for more information.


P_SSEARCHBUT
Search button:  Click this button to start a search.  Note that you can also initiate a search by pressing Enter when the focus is in the Search Results list or the Search String, Replace String, Path, & Mask fields.


P_SSEARCHREPBUT
Search and Replace button:  Begin a search & replace operation by clicking here.  Depending on your settings in Replace Options, you will be prompted before confirmations.  We recommend that if you use this feature you also enter a backup path in the Replace Options.


P_SOPTIONSBUT
Options button:  Click this button to display the Options dialog.


P_STOUCHBUT
Touch button:  Click here to touch (change the date & time stamp) the files found using the mask(s) provided in the specified directory.  See Touch dialog for more information.


P_SSCRIPTBUT
Script button:  Click this button to activate the Script Editor.


P_SABOUTBUT
About button:  Click this button to view system information, Ordering Information and License Information.


P_SEXITBUT
Exit button:  Click this to exit Search and Replace for Windows.


P_SRESULTSLIST
Search Results List

Your search results are displayed there.  The file name and the strings found are displayed in different colors.  If you have trouble seeing the strings or names, try changing the colors from the General Options dialog.

Note:  In the model screen here, the right click menu available in the results list has been captured for purposes of an example (lower right corner).  Normally, this is not displayed until you right click on a file or search results line.

To activate the View Context dialog, double click on a line where the search string is displayed.  For example, in the current example, if you were to double click on the highlighted line in the current example (Line 22 - …), the view context dialog would be displayed with the search string highlighted.

If you want to Shell the executable associated with it (in File Manager), double click on a filename line.  In the example screen, if you wanted activate the web browser associated with .htm files on your computer, double click on the line immediatedly above the highlighted line, e.g, the line that says, "Processing file : D:\EXAMPLE\Search(grep) and Replace for.htm".

By pressing the Ctrl+C key, the entire contents of the list box are copied to the Clipboard.


P_SRCLICKMENU
Right Click View Context Menu:  This menu is displayed after you right click on a file or search results line.  It allows you choices for viewing results.  The items are the same in the upper portion of the Search and Replace View Menu on the menu bar.


P_SRCLICKASSVIEW
Open with Associated File

Select this from the right click menu to open the current file using the associated viewer.  If no viewer is associated with that file extension, the default viewer, configurable in the General Options tab under Options, is used (default is NOTEPAD.EXE).  The file to open is determined by the focus in the Search Results list (marked by a thin rectangle or a higlight).  If the Search Results list contains nothing, this item is not available.

In the current example, if this item were chosen, the web browser associated with .htm files would be launched.

Note:  If the file is in a ZIP file, it is extracted to a subdirectory of the path specified in the Search Options tab.  If you edit it, you must then update the ZIP file since ZIP files are NOT automatically updated.


P_SRCLICKDEFVIEW
Open with Default Viewer

This item in the right click menu will launch the Search & Replace default viewer (configurable in the General Options tab under Options).  NOTEPAD.EXE is used if no default viewer has been defined.  The file to open is determined by the focus in the Search Results list (marked by a thin rectangle or a highlight).  If the Search Results list contains nothing, this item is not available.

Note:  If the file is in a ZIP file, it is extracted to a subdirectory of the path specified in the Search Options tab.  If you edit it, you must then update the ZIP file since ZIP files are NOT automatically updated.


P_SRCLICKOPENWITH
Open with...

Select this from the right click menu to open the current file using a viewer of your choice.  A Select Viewer dialog will allow you to select the viewer to use.  If the Search Results list contains nothing, or if the focus is on a filename line, this item is not available.

Note:  If the file is in a ZIP file, it is extracted to a subdirectory of the path specified in the Search Options tab.  If you edit it, you must then update the ZIP file since ZIP files are NOT automatically updated.


P_SRCLICKVIEWCONTEXT
View Context

This will item in the right click menu will activate the Search & Replace internal context viewer.  The file will be opened at the point of the found search string, which will be highlighted.  The highlight color, number of lines displayed in the context viewer, and fhe viewer font are configurable under in the General Options tab under Options.  If the Search Results list contains nothing or if you have the focus on a filename line, this item is not available.

In the current example screen, the file D:\EXAMPLE\Search(grep) and Replace for.htm will be displayed in the context viewer at line 22.

Note:  The Search and Replace context viewer displays text only.  However, the Search and Replace automatically detects binary files and will launch our freeware application, HexView for Windows 95/NT, which can display and print any file as a hex dump.  HexView can be downloaded from our web site.  See Product Information for further details.

Note:  If the file is in a ZIP file, it is extracted to a subdirectory of the path specified in the Search Options tab.  If you edit it, you must then update the ZIP file since ZIP files are NOT automatically updated.

Please see View Context dialog for more information.


P_SRCLICKCLIPBRD
Copy to Search Results to Clipboard:  Selecting this from the right click menu is the same as pressing CTRL-C anywhere in the Search Results list.  The contents of the list are copied as text into the clipboard.